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Objectives 


t 



- Learn how JDeveloper may be used to create 
ADF-based applications 

- Become familiar with ADF Faces and how it is 
used to create user interfaces 

- Use ADF BC to model data and address 
business rules 
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Who Am I? 


t 



• John King - Partner, King Training Resources 

• Providing training to Oracle and IT community for 
over 20 years - http://www.kinqtraininq.com 

• “Techie” who knows Oracle, SQL, Java, and 
PL/SQL pretty well (along with many other topics) 

• Leader in Service Oriented Architecture (SOA) 
design and implementation 

• Home is Centennial, Colorado - I love it here! 

• Member of ODTUG (Oracle Development Tools 
User Group) Board of Directors 

• Active member of Rocky Mountain Oracle Users 
Group (RMOUG) 
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Who Are You? 


t 



• Forms Developer 

• Java Developer 

• Both 

• Neither 
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Is Forms Going Away? T 

Training Resources f J > V 

• NO, NO, NO, NO, NO 

• Oracle is committed to supporting Oracle Forms for 
many years to come 

• A new version of Oracle Forms (12g) is on the way! 
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Why ADF? f' 

• Oracle Application Development Framework (ADF) 
is a Java-based development tool (much like Forms 
is a PL/SQL-based tool) designed to take full 
advantage of Java Enterprise Edition or Java EE 

• Java EE is one of the most widespread application 
environments today 

• Oracle is rewriting their ERP stack as “Fusion 
Applications” using ADF; the already rich toolset 
gets richer every day 
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Do I Need To Know Java? 


• Probably not well 

- Much the same as someone with basic PL/SQL 
could create very basic Oracle Forms 

- Someone with very basic Java and Web Skills 
can easily create applications with ADF 

• Someone on your team needs to know Java very 
well 

• Someone on your team needs to understand ADF 
and its available components very well 
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What is ADF? 


t 



• ADF is a “meta-Framework” interacting with a variety of 
underlying software components (including Frameworks) to 
provide: 

- Database connectivity and transfer 

- Mapping of application views to data sources 

- Database interaction: constraints, keys, data types, 
master/detail, null handling 

- Data caching via entity objects 

- Transaction management (locks, commit, rollback, etc...) 

- Declarative validation 

- Business logic and event handling 

- User Interface (Ul) logic, flow, look & feel 

- Data-bound Ul Components 

- Ul properties including: formatting, colors, defaults, visual 
components, LOVs, etc... 
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ADF Technology Stack ^ 

Training Resources f J > V 


• ADF Technology simplifies interaction with “Java” EE 
and Oracle’s Fusion Middleware 



Controller 


Model 


Services 


Data 

Services 
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ADF: Two Major Pieces ^ 

Training Resources f J > V 

• ADF has many parts but two are central to creating 
applications 

-ADF BC Business Components (data) 

-ADF Faces Graphical User Interface 
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ADF Business Components (ADF BC)T 

• ADF Business Components is a framework that 
simplifies developing Java EE business services 

• ADF BC is part of the ADF Business Services layer 
and is used to: 

- Provide persistence and data retrieval with SQL 
using data views 

- Object-Relational Mapping (ORM) between Java 
classes and database data 

- Simplified data access, validation, and business 
logic 

- Provide transactional infrastructure 

- Implement best practices 
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Arte? ADF BC Objects f' 

• ADF BC is implemented using a variety of objects to: 

- Define query views (read-only) 

- Define Insert-Update-Delete views to perform 
data manipulation 

- Define links between queries 
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L J 


Database 
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ADF BC Components ff' 

Training Resources f I > V 


• ADF BC uses a variety of object types to represent data: 

- Database tables and views Application Base Data 

- Entity Objects Business rules, validations, 

defaults for a table (or view) 

- View Objects SQL output to query, filter, 

join,modify, or sequence data 


- Application Modules Use View Objects to 

access/modify data acting as 
a back-end data service 


- Appl. Module Data Model Describes actual View 

Object uses 

• Objects may be reused in multiple Application Modules 
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ADF Data Binding ff' 

Training Resources f > V 

• After identifying Entity Objects and View Objects two 
additional ADF Data Model components are used 

- Data Controls Java objects used to 

abstract View Object 
Business Services 

- Binding Containers Java object; provides 

data access to a single 
ADF application page, 
fragment, or activity 
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Java Server Faces (JSF) ^ 

Training Resources X V I J V 

• Java Server Faces (JSF) is a Web-tier framework of 
JSP technology and JSP Tag libraries to create and 
use User Interface components 

• JSF is extended by components of Oracle ADF 
Faces 

• JSF includes: 

- Runtime architecture 

- Library of JSF components 
-JSF “Life Cycle” 

- Many JSF-Oriented Files 
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ADF Faces 


t 



• Even though JSF sought to simplify user interface; it 
is often felt to be too complex 

• Oracle has extended JSF as “ADF Faces” providing 
a set of libraries and tags that include enhanced Ul 
components and easier use 

• Oracle has presented ADF Faces to the Open 
Source community where it is part of the Apache 
Foundation Trinidad MyFaces project 

http://myfaces.apache.org/trinidad/index.html 
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Using ADF 



• Using ADF Faces is simple using JDeveloper: 
-Application layout containers 

-Add ADF Faces components to layout containers 
-All Ul is done with ADF Faces; no HTML coding 

• Features added by ADF Faces: 

- Pop-ups and Dialog boxes 

- Data Visualization Tools: Charts, graphics, etc... 

- Declarative AJAX support 

- More... 
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ADF Controller 


t 



• The ADF Controller extends the JSF controller and 
controls ADF’s MVC (Model-View-Controller) in 
ADF 

• ADF Controller features include: 

- Sequence of page displays (may be conditional) 

-Allows partial-page processing in the same way 
as full page processing; only the necessary part 
of a page is rendered, the rest is unchanged 

-Allows reuse of page parts 

- Provides conditional control of page flow 
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ADF Faces “Rich-Client” Features ^ 


• ADF Faces is designed to create “rich-client” (RC) 
interfaces; full-featured and declarative including: 

- Complete JDeveloper support graphic 
development (screen-painter) and property 
palettes 

-Visual Editor 

- Property Inspector 

- Changeable “skins” to easily alter look-and-feel 

- Modifiable look-and-feel properties (declarative) 

- Layout control 
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t 


Oracle JDeveloper 

• JDeveloper provides a world-class, easy to use IDE 

• JDeveloper llg is Oracle's latest release 

• Oracle has extended JDeveloper beyond Java to include: 

- Oracle ADF modeling, business services, and GUI design 

- XML edit including Syntax Checking & Schema Validation 

- SQL development including debugging of stored PL/SQL 

- UML Modeling and MDA (Model Driven Architecture) 

- Web Services development 

- ESB design 

- BPEL design 

- Portlets 
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Downloading JDeveloper Ti 

Training Resources f I > V 

• JDeveloper is Free! 

• To learn more about JDeveloper, see Oracle's 
website: 

http://www.oracle.com/technology/products/jdev/index.html 
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Oracle WebLogic Server ^ 

• Oracle WebLogic Server is Oracle's preferred 
platform to provide both a standard Java EE 
environment and an environment specifically tailored 
to Oracle Fusion Middleware; providing: 

- Complete Java EE 5 compatibility 

- Complete Java SE 6 compatibility 

- Web Services support 

- Integration with Oracle's Fusion Middleware tools 
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Oracle AS and OC4J? 


• Oracle WebLogic Server is the replacement for 
Oracle Application Server (OAS) and OC4J 

• OAS and OC4J are still supported and may be used 
instead of WebLogic if desired 

• To learn more about Oracle WebLogic Server see 
Oracle's website: 

http://www.oracle.com/appserver/index.html 




http://www.kingtraining.com 


24 


Copyright @2010, John Jay King 




Starting JDeveloper 

Training Resources A I 


t 




JDeveloper Studio 11.1.1.1.0 



•F*) Grade WebLogic 

► 

- Programs 

► 



Oracle JDeveloper 1 lg 
11 . 1 . 1 . 1.0 

Productivity with Choice 


ORACLG* 


Copyright © 1997, 2009 Oracle and/or its affiliates. All Rights Reserved. 
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JDeveloper - Select Role ^ 

Training Resources X I ) \ 
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Ajfe# JDeveloper - Start Page ^ 

Training Resources X I J V 



Editing 
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o> 


Training Resources 


Exploring JDeveloper 


t 


*Navigator(s) 


Toolbar(s) 


Oracle JDeveloper 11g - JavaSamples.jws : JavaSamples.jpr : 

Fie Edit View Appication Refactor Search Navigate 

3&B9 *) > X IQ Ci O * • 

^Application Navigator 
3 JavaSamples 
Projects 

E luj JavaSamples 

31 CJ Application Sources 
a CD Web Content 
E CD WEB-INF 


□ ? Start Page , WetcomeJSP.jsp 

- a • 


3 WefcomeJSP.jsp 
Application Resources 
Data Controls 
Recently Opened Files 

)I WefcomeJSP.jsp • Structure 

j tm 

IS CD Warnings (1) 

B Ohtml 

t^l WefcomeJSP.jsp 

B a ei 

3 scriptlet 
B Q3 body 
B O hi 

A Hello World! 
A Current time: 
Source | Design 


rfDPB 1 

:\jdevinstarKe\myworkV)avaSamplesUavaSamples\public_himf\Welcon :JSP.Jsp| line 



B <nn<L> 

W elcooeJSf.jsp —> 

TITLE:- Creating Hello World vj 


I 


7 <<i request.setAttribute ("title", ' 

3 

» B <BODY> 


<brxbr> 

a 

<% for(lat 1 - l;i < S;i++) ( *> 

<TtJHT SIZE-<3-li»Hello WorJ 

B 

<% ) %> 

</BODY> 


JSP 

- 

X 

o 

ua Attribute 
[D Body 
<1 Declaration 
(Z3 EL Expression 

O Element 

A 

<■ Expression 

IX Fallback 



i 

Cf Head - Property Inspector ^ 

^ T 

a j to 

♦ ♦)( 

Profile: 

Internationalisation 

Dir: < default > 


Lang: 

> 


* Structure Displays 


7 


^Palette(s) 


^ Property 
Inspector 


Editor Area and Message Area 
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Applications and Projects T 

Training Resources X II J J V 

• JDeveloper uses a non-standard, Oracle-specific 
“Application” to group a collection of “Projects” 

• All files representing an “Application” share a 
common root directory (folder) on a disk 

• Many Applications may be open at once in 
JDeveloper; but only one at a time will be visible in 
the Application Navigator 
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A2%# JDeveloper Directory Structure V' 

Training Resources X I J J V 


JavaSamples 


□BQ' 

I Rle Edit View Favorites Tools He)j 


• 

^ Back - $ , Search 

^ Folders 


Address q C:\jdevinstance\mywork\JavaSamples\JavaSamples v H Go 

Folders 

x Name +> 

0 Q JavaSamples 

A Q classes 


s l£) JavaSamples 
e £3 classes 
© IcJ .data 
© l£^) -wlsjsps 
myClasses 
Q samples 
C3 spincup 
Q threadTests 
e l^| public_html 
Q WEB-INF 
e ^ src 

ICJ myClasses 
Q samples 
£□ spincup 
CD threadTests 
a ProjectlExtra 
e classes 
© lcJ .data 
^ samples 
© l^| src 

Irll samples 


t3public_html 
tjisrc 

HlJavaSamples.jpr 


< 


UF j..ght @ 2010, John Jay King 
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Ajfe# JDeveloper Editing ^ 

Training Resources X I J V 


JDeveloper has a variety of Code Editors and Visual Editors; 
including: Java, XML, HTML, JSP, JSF/ADF Faces, BPEL, and 
more 


•l> Start Page [ ^ PepttrapPaQejspx 
IsQ - Show -1 1024 x 768 - | © | None 

ORACLE' 


- Def 


& # B / 


Show Detail Item - Departments 
Departments 

#{...DepartmentM..label} *{ 

#{.. DepartmentName .. #{ 
label} ini 
#{. Managerld...label} #{ 

#{. .Locationld...label} #{ 
Fist Query Previo: 


ly Options - View - 


u 


#{ . FirstName label} 


#{ ...LastName.label} 


#t...LastName} |#f...Emal} 


showDetailltem 1 


#< ...PhoneNumber 
#{ ...HieOate 


label} #{ 
label} 
label} #{ 
label} i 
label} t 
label} #{ 


» « 


Employeeld inputValue} 
FirstName.inputValue} 


LastName.inputValue} 


PhoneNumber.inputValue} 
HireDate. inputValue} 


Salary.inputValue} 


jspiroot ► fiview ► af:document#dl 
Design Source Bindings Preview History 


► afifbrnu 

story < 


i#fl ► af:pagetemplate#ptl ► f: facet 


http://www.kingtraining.com 


31 


Copyright @2010, John Jay King 




























































JDeveloper Debugging ^ 


• JDeveloper allows both local and remote debugging 

Oracle JDeveloper 11g - HRSystem.jws : ViewController.jpr 

File Edit View Application Refactor Search Navigate BuBd Run Versioning Tools Window Help 

£^■9 xa* a- * a jm » 11 ■ 
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JDeveloper Preferences 


• JDeveloper is customizable; preferences may be 
viewed/modified using Tools->Preferences 
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New Application ^ 

Training Resources f II > V 


To create a new application use the JDeveloper menu's File- 
>New->General->Applications option 


££ Oracle JDeveloper llg 

File Edit View Application Refactor Search H 


^Application Navigator Q 


ft 

New Application... 

ft 

Open Application... 


c\< 
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t 


Ajfe# New Gallery 

Training Resources f J 
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Application Structure ^ 

Training Resources X II ) \ 

• When a JDeveloper ADF Web Application is created 
ADF uses the MVC (Model-View Controller) pattern 

• JDeveloper creates two subordinate projects 

- Model Data and Business Rules 

- ViewController User Interface 

-ADF provides the “Controller” 


http://www.kingtraining.com 


36 


Copyright @2010, John Jay King 




File Structure 


t 



• Review the directory structure created to support the 
application and the associated projects 


0 & MyAD FAp pfccation 
© .adf 
© l£3 Model 
© £3 src 

© (h VieivController 
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How It Looks In JDeveloper ^ 

Training Resources f I > V 
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Create ADF BC Objects f' 

• The following pages show how to create ADF BC 
objects using the Wizards provided by J Developer 

• Each object created may be created individually 
using JDeveloper's features or by coding them 
manually rather than using the Wizards 

• JDeveloper's database modeling capabilities are 
shown to good effect by the use of Database 
Connections and Wizards 
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Wizard-Based Development fT 

Training Resources f I > V 

• The “Create Business Objects from Tables” Wizard 
follows a few simple steps: 

- Create Business Component, select type of 
Business Component to be built 

- Select Database Connection to be used 
(may create Database Connection via Wizard) 

- Build Entity Objects using database Tables/Views 

- Build Updateable View Objects (if desired) 

- Build Read-Only View Objects (if desired) 

- Save Application Module 
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Arte? New ADF BC Object: 1 ft" 

Training Resources f J > V 

• Start building new components as follows: 

• Right-click on the application's “Model” project 
and choose “New” 


^Application Navigator 0 

2' Build Appl 

S] MyADFApplication ▼ H) ^ 

Show: All P 

Projects HD V T 3a? " 

Tile Summa 


m Iljj iriu 

0 @ Vie 

B-ca 

3 New... Ctrl-N 

Edit Project Source Paths... 

X Delete Project 

Version Project... 
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Atfe? New ADF BC Object: 2 ft" 

Training Resources f J J V 


• Choose Business Tier -> ADF Business Components -> 
Business Components from Tables from the “New Gallery 
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Choosing Database Connection T 

Training Resources f J V 

• Choose an existing Database Connection from the drop-down 
list or build a new one by clicking the green plus sign 
(Oracle client andjnsname.oniot required!) 
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Create Database Connection 'R 
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Create BC from Tables, 1 ^ 

Training Resources X ' J V 


• Add, verify, or alter package name as desired; verify Schema to 
be used; modify filter (if desired) using SQL “LIKE” wild cards; 
click “Query” to view accessible database objects 
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Create BC from Tables, 2 ^ 

Training Resources X ' J V 


• Choose the tables and/or views to be part of the Entity Object 
and move them to the “Selected” side of the wizard display 
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Create BC from Tables, 3 

Training Resources X ' J V 


• After creating Entity Objects; the wizard offers to create 
Updateable View Objects -- View Objects represent the output 
of SQL (used to query, filter, join, modify, or sequence data) 
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Create BC from Tables, 4 ^ 

Training Resources A ' J V 

• Select Entity Objects to be used by the view being 
created; move them to the “Selected” side of panel 
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Create BC from Tables, 5 ^ 

Training Resources X ' J V 


• After creating Updateable View Objects; the wizard 
goes on to create Read-Only View Objects 
(might be useful to support an LOV (List-of-Values)) 
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Create BC from Tables, 6 fj' 

Training Resources X ' J V 

• Name the Application Module and save it; click Finish 
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Business Component Files T 

Training Resources f I > V 


• Note the use of XML to declaratively support ADF BC 


^ Oracle JDeveloper 11g - MyADFA 

Fie Edit View Application Refactc 

aaas xii • < 

. Application Navigator 

El MyADFApplication ▼ E) w 

Projects iH ’ 

a® Model 

[=1 Si Application Sources 
S i myadf.model 
I$1 ® Dept 
a ® DeptView 
® tgl Emp 

a ^ EmpdeptfkAssoc 
@-•€0 EmpdeptfkLink 
S ® EmpView 
[+ id MyADFAppModule 

Model, jpx v 

Application Resources 
Data Controls 
Recently Opened Files 
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Qcommonj 
HjDept.xml 
B DeptView.xml 
111 Emp. xml 

B EmpdeptfkAssoc.xml 
B ErnpdeptfkLink.xml 
@EmpView.xml 
B Model.] px 

B Mod elBun die. properties 
IB MyAD FAp pMod u le.x m I 
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Business Component Browser 

Training Resources f I > V 


• JDeveloper provides a 
tool to “browse” 

ADF BC Application 
Module objects 
graphically; using the 
Application Navigator, 
find the Application 
Module to be viewed; 
right-click and choose 
“Run” to start 


^Appfication Navigator X 

lilj) MyADFApplication ▼ ■ 

Projects ^1 SB Y ’ 35 ” 

e-® Model 

G~C3 Application Sources 
B 9 myadf.model 
B - ^ Dept 
0 Q DeptView 
0 Gji Emp 

a EmpdeptfkAssoc 

0 £$ EmpdeptfkLink 
0 £9 EmpView 
‘I MyAC 
^ Modi 
Application Resourc 
Data Controls 

Recently Opened Fi ^ Delete Safety 
Rnd Usages 


□ 


; = MyADFAppModule. 

B dfi| MyADFAppModi 

}. ea Properties 

| £3 Data 


2 Build Applications I Start 
Show: All Projects'" 

Trie Summary: Total: 11 O 


Java Files 

Overview 

Java Class 
Java Interface 


The Java File 
and interface 


Open MyADFAppModule 


Refactor 


Configurations... 

Business Components Deployment... 


I> Run (Working Set) 

& Debug (Working Set) 
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Component Browser Choices T 

Training Resources f I > V 

• Choose the Business Component to be tested 


Oracle Business Component Browser (MyADFAppModuleLocal-Local) [— ~]|Tn|^3 

FSe View Create Database Help 

: ® 

& MyADFAppModule 

- DeptViewl 


- lEmodeDtfkLinkl I 

£3 EmpView2 
£3 EmpViewl 

Name:MyADFAppModule.EmpdeptfkLinkl Definitiorcmyadf.model.EmpdeptfkLink 
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Component Browser - Display, 1 ^ 

Training Resources f * • ~ ) l 

• Oracle’s Business Component Browser displays 
data from the underlying database objects 
(this should look familiar to Forms users) 

• If referential keys are defined in the database 
(Primary Keys and Foreign Keys) the ADF BC 
Wizard automatically arranges the tables into a 
Master-Detail relationship 
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Component Browser - Display, 2 ^ 

Training Resources f ^ ) V 


Oracle Business Component Browser (MyADFAppModuleLocal-Local) ' ][r"l|^ 

File View Create Database Help 

: ® 

>1l MyADFAppModule 

- DeptViewl 

£3 EmpdeptfkLinkl | 

- (EmpdeptfkLinkl I 

£51 EmpView2 
£3 EmpViewl 


Deptno 

Dname 

Loc 

10 

ACCOUNTING 

NEW YORK 


l< < 

Empno Ename Job 

Mgr 

Hired... Sal 

Comm 

Deptno 


7782 CLARK MANAG... 

7839 

1981-0... 2450 

IHH 

10 

7839 

KING 

PRESID... 


1981-1... 

5000 


10 

7934 

MILLER 

CLERK 

7782 

1982-0... 

1300 


10 


Name:MyADFAppModule.EmpdeptfkLinkl Definition:myadf.model.EmpdeptfkLink 
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Ajfe# Searching Data fj" 

Training Resources X ) V 

• Use the “Specify View Criteria” (Binocular) icon to Search & 


Oracle Business Component Browser (MyADFAppModuleLocal-Local) QBQ 

File View Create Database Help 




£|| MyADFAppModule 

- £3 DeptViewl 

- ftl EmpdeptfkLinkl 
£3 EmpView2 
£3 EmpViewl 

EmpdeptfkLinkl | 

n m » 

Deptno 

Dname 

Loc 

I Specify View Criteria 

20 

RESEARCH 

DALLAS 


l<< 

Empno Ename Job Mgr Hired... Sal 

Comm Deptno 


7369 SMITH CLERK 7902 1980-1... 800 

1 120 

7566 

JONES 

MANAG... 

7839 

1981-0... 

2975 


20 

7788 

SCOTT 

ANALYST 

7566 

1982-1... 

3000 


20 

7876 

ADAMS 

CLERK 

7788 

1983-0... 

1100 


20 

7902 

FORD 

ANALYST 

7566 

1981-1... 

3000 


20 



Name :MyADFAppModule.EmpdeptfkLinkl Definition:myadf.model.EmpdeptfkLink 
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Search View Criteria 


t 



• Enter Search criteria and click “Find” 
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Search Results 


t 



__ Oracle Business Component Browser (MyADFAppModuleLocal-Local); „ ][n|[^| 

Fie View Create Database Help 


% 


MyADFAppModule 
- DeptViewl 

-ft} EmpdeptfkLinkl 
^1 EmpView2 
ft\ EmpViewl 

EmpdeptfkLinkl | 

K < > >1 =3> X » 9. W 9 

Deptno 

Dname 

Loc 

20 

RESEARCH 

DALLAS 


K < » S>l =3” X * tS. * 9 

Empno Ename Job Mgr 

Hired... Sal 

Comm Deptno 


7369 SMITH CLERK 7902 

1980-1... 800 

20 

7566 

JONES 

MANAG... 

7839 

1981-0... 

2975 


20 

7788 

SCOTT 

ANALYST 

7566 

1982-1... 

3000 


20 

7876 

ADAMS 

CLERK 

7788 

1983-0... 

1100 


20 

7902 

FORD 

ANALYST 

7566 

1981-1... 

3000 


20 



Name:MyADFAppModule.EmpdeptfkLinkl Definition:myadf.model.EmpdeptfkLink 
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Ajfe# Browsing Database Objects fT 

Training Resources f J J V 


• J Developer’s Database Navigator allows browsing of 
database objects (parts of Oracle's SQL Developer 
tool have been incorporated into JDeveloper) 


^Application 1 03 Run... 

% 56 T 

Tables 
&-W BONUS 
el® DEPT 
&-W DUMMY 
Eh® ^0 

|.i EMPNO 

|.i ENAME 

|.i JOB 

|.i MGR 


JaT“L Q j . DeptEmpJSFPage.jspx |LQEmp.xml |[>john oralll ®EM;I 
^ Actions... 

(j Column Name [ 1 Data Type ill Nullable | Data Default | | C 


EMPNO 

NUMBER{4,0) 

No 

(null) 

ENAME 

VARCHAR2(10 BYTE) Yes 

(null) 

JOB 

VARCHAR2(9 BYTE) 

Yes 

(null) 

MGR 

NUMBERED) 

Yes 

(null) 

HIREDATE 

DATE 

Yes 

(null) 

SAL 

NUMBER{7. r 2) 

Yes 

(null) 

COMM 

NUMBER{7,2) 

Yes 

(null) 

DEPTNO 

NUMBER{2,0) 

Yes 

(null) 
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Modification of Application T 

Training Resources X II ) \ 

• Once the initial Business Components are created in 
the application, it might be useful to: 

- set default values 

- define formatting 
-validate data 
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o> 


Training Resources 


Object Properties 


t 


Like Oracle Forms (and other 4GLs) properties are 
listed 


t^Hiredate - Property Inspector 

□ 

(3 ft W / (ft 

♦*)© 

BUI Hints 

A 


0 Label: | Hire Date 


° Tool Tip: 1 Hire Date dd.mm.yyyy 

|v 

Control Type: | <default> 

-F 

Display Hint: <default> (Display) 

r|- 

Display Width: [j 

F 

Display Height: ]_ 

F 


° Format Type: 
Format: 

Form Type: 
Auto Submit: 


lat.DefaultDateFormatter M ' 


dd.MM.yyyy| 


10 ' 


<default> (Detail) ▼ ' 


default(false) 


Custom Properties 
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Properties in XML Files ^ 

Training Resources f I > V 


• ADF uses XML files to store declared definitions 


2) Build Applications | ?)Start Page I^MyADFApplication.jws ^ jEmp.xml C 


ft' 

Find 

■ A') 1 

70 

B; 

<Attribute 

71 


Name="Hiredate" 

72 


C o lumnName= "HIRED ATE " 

73 


SQLType = "TIME STAMP" 

74 


Type="oracle .jbo.domain.Date" 

75 


ColumnType = "DATE" 

76 


TableName="EMP"> 

77 


<TransientExpression>< ![CDATA[adf.currentDate] ]></TrajisientE:xpression> 

78 

B 

<DesignTune> 

79 


<Attr Name="_DisplaySize" Value="7"/> 

80 


</Desi<jnTime> 

81 

B; 

<Properties> 

82 

E; 

<SchemaBasedProperties> 

83 

& 

<LABEL 

84 


ResId= "myadf.mo de1.Emp.Hire date_LABE L" /> 

85 

B 

<T00LTIP 

86 


Resld="myadf .model.Emp.Hiredate_T00LTIP"/> 

87 

B; 

<FMT FORMATTER 

88 


Re sId= "myadf.mo de1.Emp.Hir e date_FMT_F0RMATTER" /> 

89 

B 

<FMT_F0RMAT 

90 


Resld="mvadf . model. Emo. /> 

91 


< /SchemaBasedProperties> 

92 


</Properties> 

93 


</Attrilnite> 

94 

B 

<Attrihute 

95 


Name ="Sal" 

Ovprvipw 

Source | History I L™—^^* [J 
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Modify Appearance and Formatting T 

Training Resources f ^ ) V 

• Use JDeveloper to modify appearance of database 
column values by double-clicking an Entity Object 


^Application tlavigator Q 


lS MyADFApplication 

~ ^[[5H 

Projects 

HLir7“ai“ 1 

□■••{U Model 


0-E3 Application Sources 
El--® myadf.model 
Dept 

El-S DeptView 
EB""1-^ 

•± EmpdeptfkAssoc 
$■■■■?§ EmpdeptfkLink 
t]--Q EmpView 
i-jfil MyADFAppModule 
1 Model.]px 
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Entity Object Edit Panel ^ 

Training Resources A J J J V 
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Entity Object Attributes ^ 

Training Resources X y J J V 


l ) Build Applications l 1 /?; Start Page ll^lMyADFApplication.j ws .jEmp.xml _ Q 

General 

Attributes Attributes 4* ^ X Add from Table... J) 

Validators Entity attributes can be based upon columns in the schema object or can be based upon 

j ava transient values. 


to 


#♦) 


Name 

Type 

Column 

Column Type Extends 

r “ Empno 

Number 

EMPNO 

NUMBER(4, 0) 

Ename 

String 

ENAME 

VARCHAR2(10) 

Job 

String 

JOB 

VARCHAR2(9) 

Mgr 

Number 

MGR 

NUMBER(4, 0) 

Hiredate 

Date 

HIREDATE 

DATE 

Sal 

Number 

SAL 

NUMBER(7, 2) 

Comm 

Number 

COMM 

NUMBER(7, 2) 

Deptno 

Number 

DEPTNO 

NUMBER(2, 0) 



a Validation Rules: Empno + / X 

a Custom Properties: Empno + / X 

a Security: Empno 


Overview Source History 
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Entity Object Validators fj' 

Training Resources X J J J V 


U Build Applications I 1) Start Page 1 Id MyADFApplication.jws [ ^Efuiwl 

General 

Attributes Validators 

Validators 

Java 

Business Events 
View Accessors 


0 


+ /XCD 


Select the entity object or one of its attributes and click the New button to apply a new 
validation rule. 


Emp 

5’"^ Attributes 
© Sa) Empno 
© Sal Ename 
© ill) Job 
S Sal Mgr 
Sal Hiredate 
© (an Sal 
©■ s»a Comm 
©■• Sal Deptno 
Entity 


[® 


Overview Source History 
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Validations and Business Logic 

Training Resources X J V 

• Validations and Business Logic may be added including: 

- Client-side validation 

- Format masks 

- Default Values 

- Declarative Range (and other) Validation 

- CSS (Visual Attributes) 

- List of Values 

- Calculated field 

- Code Validation 

- Extensible for complex application validation 

- Transactional Triggers 
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Validation Rules 


t 



NUMBER(7, 2) 
NUMBER(2, 0) 


l| P 


Validation Rules: Sal 

Click the New button to apply a new validation rule. 


+ / X 


Add Validation Rule for: Sal 


a 


Define the Validation you want to perform with this rule and configure the Validation 
Failure response. 


Validation Rule 
Precis ion : (7,2) 


1 ® 

m 


| Rule Definition Validation E) 


ffl Custom Properties: Sal 

•¥'/* 



Operator: Between 



Minimum Value: [5OO 

1 


Maximum Value: &000| 

1 


Hint: Enter valid values for the selected attribute's type. 


L wp_.J 
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Validation Error Messages fT 

Training Resources X J V 
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Attribute Defaults 


t 



• Using the Property Palette, open the “Value” 
properties and set the default value (in this case 
“adf.currentDate” using ADF’s “Groovy” support) 

'^Hiredate - Property Inspector _ Q_ 

a ♦♦)© 
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o> 


Training Resources 


Attribute Formatting 


t 


Use an Attribute's Property Palette “Ul Hints” 
section to control formatting, label, tool tip, etc... 
(note this formatting uses Java SimpleDateFormat 


options) 


*??Hiredate - Property Inspector 

a i jt & i /■ (a> Find ♦♦) (! 


http://www.kingtraining.com 


BUI Hints 


® Label: 

* Tool Tip: 
Control Type: 
Display Hint: 
Display Width: 
Display Height: 
Q Format Type: 
a Format: 

Form Type: 
Auto Submit: 


Hire Date 


Hire Date dd.mm.yyyy 


<default> 


<default> (Display) 


Simple Date 


dd.MM.yyyy 


<default> (Detail) 


<default> (false) 
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What Does the XML Look Like? 

Training Resources f 

? Build Applications I ? Start Page I j^MyADFApplication.jws C^Emp.xml 


»• 

Find 


a 

A 

70 

B 

attribute 


71 


Name = "Hir e date" 


72 


C olumnName = "HIREDATE" 


73 


S Q LType = "TIME STAMP" 


74 


Type="oracle .jbo.domain.Date" 


75 


ColumnType = "DATE" 


76 


Tab1eName = "EMP"> 


77 


<TransientExpression>< ! [ CDATA[ adf. currentDate ] ]></TrajisientExpression> 


78 

- 

<DesitpiTime> 


79 


<Attr Name="_DisplaySize" Value="7"/> 


80 


</DesignTime> 


81 

- 

<Properties> 


82 

- 

<SchemaBasedProperties> 


83 

- 

<LABEL 


84 


Resld="myadf . model. Emp. Hiredate_LABEL r, /> 


85 

- 

<T00LTIP 


86 


Re sId= "myadf.model.Emp.Hiredate_T0 0 LTIP" /> 


87 

E 

<FMT FORMATTER 


88 


Re3ld="myadf .model.Emp.Hire date_FMT_F0RMATTER" /> 


89 

B 

<FMT_FORMAT 


90 


Resld="myadf .model. Emp. 


91 


</SchenaBasedPr operties> 


92 


</Properties> 


93 


</Attribute> 


94 

- 

attribute 


95 


Name="Sal" 

V 

Overview Source . History 

I 
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Date Mask Properties File ^ 

Training Resources f I > V 


||i] ModelBundle.properties j ~ 

# “““ ' 

myadf.model.Emp.Sal_Rule_0=Salary should be between 500 and 6000 

3 myadf.model.Emp.Hiredate_LABEL=Hire Date 

4 myadf.model.Emp.Hiredate_TOOLTIP=Hire Date dd.mm.yyyy 

myadf.model.Emp.Hiredate_FMT_FORMATTER=oracle.j bo.format.DefaultDateFormat 
6 myadf.model.Emp.Hiredate_FMT_FORMAT=dd.MM.yyyy 
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Comparison to Oracle Forms T 

Training Resources X I ) \ 

• In Oracle Forms we defined “data blocks” that 
represented tables and views that would be used in 
our forms 

• ADF BC components do that and more, plus they 
may be shared by many applications 

• In Oracle Forms once the “data block” was created 
we would then use it to create the presentation 

• With ADF we use ADF Faces to accomplish the 
same thing and more 

(again creating components that may be reused by 
other applications) 
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Creating Web Applications ^ 

Training Resources X II ) \ 

• Oracle’s Business Component Browser is 
impressive, but it's hardly a customer-facing user 
interface 

• ADF Faces extends the Java Server Faces (JSF) 
framework using XML tags to describe the user 
interface 

• ADF Faces provides a Rich-Client Interface that 
uses JavaScript and AJAX components; therefore 
users must have a reasonably up-to-date browser 
(Internet Explorer 7.0 or higher, Mozilla Firefox 2.0 
or higher, Safari 3.0 or higher) to use all of its 
features 

• ADF Faces is designed to make creation of “rich- 
client” (RC) interfaces full-featured and declarative 
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Review of Web Processing V' 

Training Resources f > V 



HTML page 
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HTML, CSS, and Forms fi 


• Even though the ultimate page delivered to the Client Browser 
is HTML; with JDeveloper's Visual Editor and the combination 
of ADF Faces and JSF Faces it uses to create .jspx pages 
there is little need for ADF Developers to code HTML or CSS 

• Yield to JDeveloper's declarative mechanism and refrain from 
coding 
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ADF Controller 


t 



• The ADF Controller extends the standard JSF 

controller and controls the MVC in ADF 

• ADF Controller features include: 

- Sequence of page displays (may be conditional) 

-Allows partial-page processing in the same way 
as full page processing; only the necessary part 
of a page is rendered, the rest is unchanged 
(makes page processing faster) 

-Allows reuse of page parts 

- Provides conditional control of page flow 
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A&f JSF Life Cycle f' 

• JSF (and ADF Faces) perform a predictable cycle as follows: 

1. Restore Components 

2. Apply Request Values 

3. Process Validations 

4. Update Model Values 

5. Invoke Application 

6. Render Response 

• This Life Cycle is normally transparent; however, it is useful to understand 
it when debugging 
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JDeveloper Visual Designer Ti 

Training Resources f I > V 

• JDeveloper's Visual Designer may be used to “paint” 
a User Interface using the Component Palette 

• The JDeveloper Visual Designer is intended to be 
WYSIWYG (What You See Is What You Get); 
however the nature of the web and HTML is that it's 
really WYSIKOWYG (What You See Is Kind-Of 
What You Get) 
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ADF Faces Component Palette ^ 

Training Resources X 1 ) \ 

• The ADF Faces 

Component Palette 
includes icons representing 
various User Interface 
objects 

• Drag-and-drop desired 
components into the 
position desired 

S3 Component Palette Lqi Resources 

ADF Faces 

$6 1 

Common Components 

Bread Crumbs 

Q Button 

0 Calendar 

H Choose Color 

0 Choose Date 

1 column 

B Dialog 

HU’ D-nf 

^ Layout 


Decorative Box 

G Document 

G Inline Frame 

HE) Navigation Pane 

0 Panel Accordion 

Ui Panel Border Layout 

0 Panel Box 
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o> 


Training Resources 


Property Inspector 


t 


When editing Web Pages, the Property Inspector 
shows properties for the various “facets” and 
components displayed upon the page 


'^Output Text - #-[row.Empno} - Prop... 


Sjl^i / flft Find # #) © 


- Common 


* Id: 


otlO 


Rendered: [<default> (true) 
3 Value: 


#{row.Empno} 


B Appearance _ 

No Wrap: | < default:?- (false) 

Truncate At: 


H v 


Description: 

ShortDesc: 


Rendered: |<default> (true) 
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Facets in Structure Window ^ 


• The “facets” are components 
that are used to contain 
groups of other components 

• JDeveloper’s “Structure” 
Window” lists facets in the 
current page 


B-ft Column facets 

lEI'i aficolumn - #{bindiings. Em pViewZ hints. Ena me. label} 
Fl! aficolumn- #{btrydings. Em pViewl. hints Job. label} 

| .A af : o utp utText - #{row.Jo b} 

B-ft Column facets 

|.ft filter 

f.ft footer 

1 .ft header 

B-i aficolumn - #{bindlings.EmpView2.hints.Mgr.label} 

! B-A af:o utp utText - #{row.Mgr} 


Column facets 


|.ft filter 

f.ft footer 

L .ft header 

j 0-| aficolumn - #{bindings.EmpView2.hints.Hiredate.label} 
+ ! aficolumn - #-[b i nd i ngs. Em p Vie w2. h i nts. Sa I . la be 1} 

B-i aficolumn - #{bindings£mpView2. hints. Comm, label} 
j B-| aficolumn - #{bindings.EmpView2.hints.Deptno.label} 
B-ft Table facets 
- Panel Collection facets 
|.ft afterT oolbar 
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Panel and Panel Splitter ^ 

Training Resources X I ) \ 

• Pages in ADF are sometimes divided by Panels; 
pre-existing templates exist to help create the 
number of desired Panels 

• Each Panel in turn may be divided into smaller 
areas using a Panel Splitter 

- By default Panel Splitters split an area 
horizontally 

- Panel Splitters have an “Orientation” property that 
allow the split to be vertical 
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Collections, Accordions, Tabbed 


• Panel Collections are facets that contain other 
objects 

• Panel Accordions are facets that contain other 
objects but shrink-and-grow depending upon mouse 
movement 

• Tabbed Panels are facets that allow components to 
be placed into a tabbed structure 


Panels^ 
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User Interface (Ul) Components fj' 

Training Resources X \ / I J V 

• Ul Components provided by ADF Faces include: 

- Buttons 

- Calendars 

- Choose Color 

- Forms 

- Input Text 

- Output Text 

- Panel Collection 

- Submit 
-Tables 

- more... 
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Binding Data fj' 

Training Resources X ) V 

• JDeveloper's interface will allow not only the 
creation of web components using drag-and-drop 
processing 

• Drag-and-drop may also be used to associate View 
Objects with Ul Components 

• This has the effect of “binding” the data to the data 
control object 
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Creating ADF Faces / JSF Pages IT 

Training Resources f ^ ) V 

• The following pages walk through the creation of a 
simple Web Application using ADF Faces and ADF 
BC objects as follows: 

1. Design Web Page 

2. Create new JSF Page using JDeveloper 

3. Add Visual Components to JSF Page 

4. Bind Visual Components to ADF BC Objects 
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Ajfe# Create ADF Faces Page ^ 

Training Resources X J V 

• To create an ADF Faces page, right-click on an 
Application's ViewController Project and choose “New” 
to display the “New Gallery” dialog 


JpApprication 

L&j Run Manager EJ 


| Sd MyADFApplication 


Projects 

si$ v- s> 


@~{H Model 

ViewControlt 



I New... 

Ctrl-N 1 



Edit Project Source Paths... 
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t 


New Gallery 

Training Resources f J 
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Naming Web Page ^ 

Training Resources f > V 



- Note the “Create as XML Document (*.jspx)” box 
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Visual Display with Initial Screen 

Training Resources f I J J V 


Oracle JDeveloper 11g - MyADFApplication.jws : ViewController.jpr : C:\jdevinstance\mywork\MyAD... 


File Edit View Application Refactor Search Navigate Build Run Design Versioning look Window Help 

3SIS XttHi 

^Application ; t»l Run Manager 


□ “ 




HjI MyADFApplication _* 

Projects ID Y 3a 

I? S] Model 
&1 ViewController 
&-Q Web Content 
@ D WEB-INF 
a Q Page Flows 

1 DeptEmpJSFPage.jspx 
Application Resources 
Data Controls 
Recently Opened Files 

DeptEmpJSFPage.jspx - Structure 

^ m 

B L2 Warnings (2) 

BO jsp:root 

; jsp:directive.page 
B [|§ f:view 


Source Design 


0 DeptEmpJSFPage.jspx 


- Show’ Full Screen Size^J [o] 


0 Co... S| Q 


ORACLE' 

ffi 

ff 





jspxoot ► fiview ► af:document#dl t> 
Design Source Bindings Preview History _ 
HD Messages - Log 


Messages Feedback 


©00 


1ADF Faces 


to o 

Common Comp... 

»>» Bread Crumbs 
□ Button 


□ 


^Inspector Q 

a / • 


• Id: |dT 

Rendered: a 

InitialFocusM: [ 
Maximized: | <tk 

Title: 

± Appearance 
+ Style and Theme 


C:\jdevinstance\mywork\MyADFApplication\ViewController\public_html\DeptEmpJSFPage.jspxl 
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Three-Column Layout fT 

Training Resources f J > V 


• The supplied three-column layout is ready to have 
objects dropped into it 


3 DeptEmpJSFPage jspx _ 0 

95 T Show T i Full Screen Size T (o)| _ T T 

ORACLE' [gj 



jsp:root ► f:view ► af:document#dl t> 


' ^ ' 

| copyright 
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Deleting Panel from Layout fT 

Training Resources f J > V 




Sometimes you want a two-column layout rather 
than three; just select the panel you don’t want and 


delete 
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t 



Common Components 


gjfComponent Palette 

|,ADF Faces 


Common Components 
Bread Crumbs 
Q Button 
0 Calendar 
II Choose Color 

5 Choose Date 
§ column 

SD Dialog 
Qjj Facet Ref 
li Form 
Q Go Button 
<#> Go Link 
•H Go Menu Item 
ID Icon 
B Image 
B Image (Active) 

$ Image Link 
$3 Input Color 

HT Input Combobox List Of Values 
11 Input Date 

6 Input File 

ST Input List Of Values 
Input Number Slider 
[*$ Input Number Spinbox 
Input Range Slider 
$3 Input Text 

http://www.kingtraining.com 


$3 Input Text 
$ Link 
Media 
JL Menu 
Menu Kern 
13 Message 
Messages 
© Navigation Item 
3 Note Window 
*%) Output Formatted 
^ Output Label 
A Output Text 
A Output Text (Active) 

30 Panel Label and Message 
JL Panel Menu Bar 
15 Popup 

ea Progress Indicator 
36 Query 
36 Quick Query 
^ Reset Button 
O Rich Text Editor 
@ Select Boolean Checkbox 
® Select Boolean Radio 
□ Select Bern 
0 Select Many Checkbox 


95 


U Select Many Listbox 
JQ Select Many Shuttle 
^ Select One Choice 
H Select One Listbox 
(5) Select One Radio 
QjQ Select Order Shuttle 
Show Detail 
Q Show Detail Kern 
Status Indicator 
|§ Subform 
111 Table 
a Toolbar 

□ Toolbar Button 

□ Toolbar Button (Active) 
Train 

Train Button Bar 
Tree 

H|| Tree Table 
0 Xml Content 
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Layout Components 

(§3 Component Palette 
ADF Faces 

ft 

Common Components 
Layout 

O Decorative Box 
3 Document 

□ Inline Frame 
Mi Navigation Pane 

Panel Accordion 
L2 Panel Border Layout 
Q Panel Box 
® Panel Collection 
Panel Dashboard 
[jjD Panel Form Layout 
=4 Panel Group Layout 
Panel Header 
jE Panel List 

□ Panel Splitter 

: Panel Stretch Layout 

□ Panel Tabbed 
HD Panel Window 
=- Separator 

Show Detail Header 
Spacer 

S3 Toolbox Copyright @2010, John Jay King 









Operations Components 


Sf Component Palette 

|adf Faces 

06 

Common Components 
Layout 
Operations 
Attribute Drag Source 
i^i Attribute Drop Target 
l^j Calendar Drop Target 
Sal Client Attribute 
£6 Client Listener 
i^i Collection Drag Source 
L^j Collection Drop Target 
Component Drag Source 
IS Convert Color 
EH Convert Date Time 
® Convert Number 
O Data Flavor 
i^i Drop Target 

Export Collection Action Listener 
£6 File Download Action Listener 
[E] For Each 
j ] Group 

Insert Text Behavior 
ID Iterator 

O Panel Dashboard Behavior 
% Poll 

^ Reset Action Listener 
l$£f Resource 

£6 Return Action Listener 
O Rich Text Editor Insert Behavior 

http://www.kingtraining.com 


Scroll Component Into View Behavior 
Server Listener 
Set Action Listener 
Set Property Listener 
15 Show Popup Behavior 

Show Printable Page Behavior 
Skip Link Target 
<£> Switcher 
& Validate Byte Length 
Validate Date Restriction 
Validate Date Time Range 
^ Validate Double Range 
& Validate Length 
^ Validate Long Range 
^ Validate Reg Exp 
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Adding Accordion Component Ti 

Training Resources f I > V 

• To add an Accordion Component to the web page; 
Panel Accordion component from the pallet to the 
desired column (“start”) 

Jb Navigation Pane 
l_J Panel Accordion 
■.j Panel Border Layout 

H DeptEmpJSfPage.jspx _ 


isB • Show ' Full Screen Size ', [©] None ■'[Default ' None' ^ B / U f = ■ 



ORACLE 




I showDetaflltem 1 
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Change Accordion Title Property ^ 

• To alter the Accordion's 
title, click on the 
Accordion and modify 
its Property Inspector 
Text item 

(changed to “Depts”) 


□ Appearance 


Flex; 

0 


InflexibleHeight: 

100 


StretchChildren: 

<■defau.lt> (n... T 

V 

Icon: 


V* 

Rendered: 

<default> (t... T 


Text 




* Text: 


Depts 


AccessKey: 



V 
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Add Data Component ^ 

Training Resources X I ) \ 

• Right-click in the “Depts” Accordion; when prompted 
choose “Insert After Show Details Item - Depts -> 

Show Detail Item” to add another Accordion to the 
page (not used further in this demo...) 


Insert before Show Detail Item - Depts 

► 

Insert inside Show Detail Item - Depts 

► 


Insert after Show Detal Item - Depts 1 


Design This Container 

Convert... 

Surround With... 

Facets - Show Detal Item ► 

Edit Template ► 

Hide in Design View 

Refactor ► 

Insert HTMl/JSP... 

Create Method Binding for Disdosu relistener 

li Attribute Drag Source 

L^j Attribute Drop Target 
& pent Listener 

A Component Drag Source 
dh Drop Target 

H For Each 

Attribute 

Browse... 
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Ajfe# Using Panel Splitter ^ 

Training Resources f I ) \ 


if Component Palette UejRes... 

Q 

ADF Faces 

-i 

ft 

a 


• To divide the right-part 
of the page (Center) 
into two parts; find the 
“Panel Splitter” 
component then drag it 
to the column marked 
“Center” 

• Next, change it's 
“Orientation” property to 
“Vertical” 


Common Components 
~ Layout 

1==J Panel Form Layout 
=4 Panel Group Layout 
*3 Panel Header 
jE Panel List 


Panel Splitter 


Panel Stretch Layout 

£3^ Panel Splitter vertical - Propert... 

a *W'S(m Fhd +*)© 

El Common 

| “Id: 

Rendered: 

PositionedFromEnd: 

Collapsed: 

0 Orientation: 

SplitterPosition: 

Appearance 
PositionedFromEnd: 

° Orientation: 

SplitterPosition: 
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|psl 

□- 

<default> (true) 

II- 

| <default> (false) 

I- 

<default> (false) 

3- 

vertical 

I- 

|<default> (horizontal) 1 

|horizontal 

_ 

vertical 1 

<default> (false) 

ri¬ 

vertical 

ll- 

200 

□ - 


http://www.kingtraining.com 

































Page After Splitting 

Training Resources f I J V 




After splitting; the page looks something like this: 



- The “Depts” part will hold specifics for one Department 

- The “first” part will hold a list of Department employees 

- The “second” part of the page will hold details for an 
individual Employee 
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Adding Collection and Tabbed Area 



• Find the “Panel Collection” 
component in the Layout 
components and drag it to the 
“first” (top) part of the Splitter 
area 


□ Panel Box 
® Panel Collection 
Panel Dashboard 


• Find the “Panel Tabbed” 
component in the Layout 
components and drag it to the 
“second” (bottom) part of the 
Splitter area 


a Panel Stretch Layout 
O Panel Tabbed 
H Panel Window 
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Data Binding: Adding Data, 1 ^ 

Training Resources X ' J V 

• To “bind” data to web page components, simply 
drag ADF BC data objects to the Visual Editor 

• Open the “Application Navigator” and expand the 
“Data Controls” accordion to see the ADF BC 
components created earlier then drag “DeptViewl” 
to the “Depts” accordion 

Data Controls 

□••te MyADFAppModuleDataControl 


DeptViewl 


i. asi) Deptno 

|. «S) Dnarne 

i. -Sin Loc 

E js| EmpViewZ 
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Data Binding: Adding Data, 2 

Training Resources X ' J V 


• When prompted; 
choose “Create Forms - 
> ADF Read-Only 
Form” to populate the 
Department data 
display 


111 DeptEmpJSFPage.jspx 

- Show ' 1 Full Screen Size ^ |gl [ None 


^ 1 Default 


ORACLE | 



E Dept J< 



Gantts 
Gauges... 
Geographic Map 
Graphs... 

Hierarchy Viewer- 

Multiple Selecdons 

Navigation 

Single Selections 

Tables 

Trees 


a ADF Form... 


ADF Read-only Form.. 


I ADF Search Form 


jsp:root ► 
Desian Soi 


Cancel 
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Ajfe# Adding Navigation Controls fT 

Training Resources X J V 

• Check the “Include Navigation Controls” box 

• You may also modify display labels and add, delete, or 
reorganize the values displayed 


m 


Edit Form Fields 




Configure the components that you want to display in your form. Note that you can remove or edit 
the resulting components after you click OK. You can also add more components directly to the 
layout later. 


Fields: 

Display Label 


a <default> 
a <default> 


Value Binding 
=> Dname 




Component To Use 


ADF Output Text w/ Label 


$3 ADF Output Text w/ Label 
3g) ADF Output Text w/ Label 


♦ 

t 

O 

a 


0 Include Navigation Controls 
I | Include Submit Button 

I Help J 


D 1 Q”*” 1 J 
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Ajfe# Department Display Area fi 

Training Resources X I I y J V 

• After adding the Department information; the “Depts” 
accordion should look like the following 

0 DeptEmpJSFPage.jspx 


T Show T Full Screen Size T 


ORACLE' 




Depts 


#{...OeptnD...labe[} #{...Dept?i 
#{...One me... label} #{...Ona(S 
#{...Ldc... label} #{...U 


£ 


First 


Previous 


Ne^t 
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Adding Department Employees fT 

Training Resources f I I y J \ 


• Next, to add Department 
Employees to the page, 
drag the EmpView2 data 


L 

View ▼ 


toolbar 

a oet 




! Create l 

Tables ► 

B ADF Table... 

Trees ► 

iss ADF Read-only Table... 

Caned 

B ADF Read-Only Dynamic Table 

J - 1 


Data Controls 

E-li^ MyAD FAp p M o d u le D ata Co ntro I 
DeptViewl 

:. HH Deptno 

j. Hsl Dname 

I. nm Log 


|EmpView2 


Comm 
Deptno 
Empno 
Ena me 
Hiredate 
■m Job 
Mgr 
■m Sal 


• When prompted, choose 
“Create Tables -> ADF 
Read-Only Table” again 
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Add Employee Navigation Controls 



• Check all three navigation controls: 

• Row Selection (user may select), filtering (user may 
search), and sort; as before columns may be 
relabelled, added, deleted, reorganized 



iuy 
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Department Employee Area 

Training Resources f I I J J V 


[yj DeptEmpJSFPage.jspx ( 

Show 1 Full Screen Size \ [g) [None ^ | Default _^ |None * ^ ^ B / U JE |E 51 SI HT” 



http://www.kingtraining.com 


110 


Copyright @2010, John Jay King 


















































Adding Individual Employee 

Training Resources f I J ) \ 


• Finally, add the individual Employee 
display to the Tabbed area at the 
bottom of the page 


showDetailltem 1 ^ 


Create \ 


Forms ► 

1 ADF Form... j 


Gantts ► 

HU ADF Read-only Form... 

mnlat]R#nt1 ► 

Gauges... 

HU ADF Search Form 


Data Controls 

B IJjJ MyADFAppModuleDataControl 
B M DeptViewl 
| <a3 Deptno 
<523 Dname 
! Hsxa Loc 


|EmpView2 


ins Comm 
1*23 Deptno 
S23 Empno 
<523 Ename 
<523 Hi redate 
<523 Job 
(523 Mgr 
I <523 Sal 


• When prompted, choose “Create Forms -> ADF Form” to 
select the display format (this part of the form will be 
editable) 
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Add Employee Navigation ^ 


Delete the COMM and DEPTNO data from the display 
(highlight & click X); check “Include Submit Button” 


Edit Form Fields 


M 


Configure the components that you want to display in your form. Note that you can remove or edit 
the resulting components after you click OK. You can also add more components directly to the 
layout later. 


Fields: 
Display Label 
Sail <default> 
ihs <default> 
sa <default> 
SsB <default> 
Sal <default> 
s*a <default> 


Value Binding 
is Empno 
is Ename 
is job 
is Mgr 
is Hiredate 
a Sal 


■ comm 


I I Include Navigation Controls 
0 Include Submit Button 


Help 


Component To Use 
$3 ADF Input Text w/ Label *— 
ADF Input Text w/ Label 
ADF Input Text w/ Label 
$3 ADF Input Text w/ Label 
HI ADF Input Date w/ Label 
$3 ADF Input Text w/ Label 


ADF Input Text w/ Label 
■ ADF Input Text w/ Label 


[ Cancel | 
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Completed Web Application Page 



0 DeptEmpJSFPage.jspx 



http://www.kingtraining.com 


113 


Copyright @2010, John Jay King 























































Testing the Web Application ^ 

Training Resources f II J V 

• To begin testing the Web Application; right-click the 
“.jspx” file created in the ViewController project and 

ChOOSe Run El-0 ViewController 

-] -P~l Application Sources 
131 ■@ myadf.view 

1 . ta DataBindings.cpx 

! £ fffl myadf.view. pageDefs 

I j . ta DeptEmpJSFPagePageDef. 

\ B'S META-INF 

1 .E3 adfm.xml 

-I-Q Web Content 
:± EI] WEB-INF 
ESQ Page Flows 

cJ DeptEmpJSFPage.jspx 


http://www.kingtraining.com 


114 


Copyright @2010, John Jay King 

















Be Patient! ^ 


• The first time you execute a Web application JDeveloper will 
start its built-in WebLogic Application Server; this takes a while 

• You can track the progress of the Server's startup in 
JDeveloper's DefaultServer Log 


E] Running: DefaultServer - Log 

twww «-~, WW > ». 1UJ.UJ im.uuuy±uui.j. • - K i-is-u x uuuu ■ »- > uui uiuy — "<-*J 

<Oct 25, 2009 1:07:52 AM EDT> <Info> <Manageroent> < BEA-141107 > cVersion: WebLogl 
<Oct 25, 2009 1:07:54 AM EDT> <Notice> <WebLogicServer> < BEA-000365> <Server sta 
<Oct 25, 2009 1:07:54 AM EDT> <Info^5^]:gganager> < BEA-002900 > Clnitializing se 

<Oct 25, 2009 1:07:55 AM EDT> <Notice> <LoggingService> < BEA-320400> <The log fl 

<Oct 25, 2009 1:07:55 AM EDT> <Notice> <LoggingService> < BEA-320401> <The log fl 

<Oct 25, 2009 1:07:55 AM EDT> <Notice> <Log Managements < BEA-170019> <The servei 


• Once the Server is “up” your web page should be displayed in a 
browser (again, please be patient!) 
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Web Page in Browser ^ 
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Files Supporting Web Application T 

Training Resources f ^ 11 > V 

• Several files make up the typical ADF Web 
Application 

-A .jspx file is used to define each web page 

-Web pages reference a page definition XML file 
(.xml) 

- Bindings are described in another XML file (.cpx) 
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JSF .jspx File f' 


ADF defines a web page using an XML .jspx file 

_J DeptEmpJSFPage.jspx Emp xmI 


<£:view> 

B: <a£^docjnnent id="dl"> 

<a£:messages id="ml"/> 

B; <af:form id="fl"> 

11 B; <af :pageTen^late viewId="/oracle/templates/threeColumnTemplate.jspx" 

id= rr ptl"> 

13 Bl <£: facet name="center"> 

B| <af:panelSplitter id="psl" orientation="vertical"> 

B; <£:facet name="f irst"> 

16 B; <a£:panelCollection id="pcl"> 

<£:facet name = "menus"/> 

<£:facet name="toolbar"/> 

<£: facet name="statusbar"/> 

<afdtcfljle value ="# {bindings. EmpView2. collectionModel}" 

var ="row" rows="# {bindings.EmpView2.rangeSize}" 
emptyText="# {bindings.EmpView2.viewable ? 'No data to display 
f e tchSiz e = "#{b indings. EmpView2. r ange Size}" 
r owB andinglnte rval = "0" 

filterModel="# {bindings.EmpView2Query.queryDescriptor}" 
queryListener ="#{bindings.EmpView2Query.processQueryj }” 
fi1te rVisib1e = "true" var S tatus = "vs" 

selectedRowKeys = rr » (bindings. Empyiewd. collectionModel. selected! 

29 

j merit#dl ► af:fbrm#fl ► af:pagetemplate#ptl ► f: facet ► af: pane laccord ion #pal ► af:showdetailitem#sdil t> 
Design Source | Bindings | Preview History 


19 


21 

22 


24 


27 
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ADF Web Page Definition file (.xml) 



DeptEmpJSFPage.jspx _J DeptEmpJSf PagePageDef.xml Emp.xml_ B 


16- 

Find 


= 

1 

1 

:< 

’xml version="1.0" encoding= ,r UTF-8" ?> 




2 

E cpageDefinition xmlns="http: //xmlns.oracle.com/adfm/uimodel" 




3 


version="ll. 1.1.54.7" id="DeptEmpJSFPagePageDef" 




4 


Package ="myadf.view.pageDefs"> 




5 


parameters /> 




6 

- 

<executables> 




7 


cvariablelterator id="variables"/> 




8 

- 

citerator Binds ="DeptViewl" Range Size = rr 25" 




9 


DataContro1 = "MyADFAppModuleDataControl" id= "DeptViewlIterator" 




10 


ChangeEventP o1icy = "pp r" /> 




11 

- 

citerator Binds="EmpView2" RangeSize="25" 




12 


D ataC ontr o1 = "MyAD FAppMo duleDataControl" id="EmpVi ew2Iterator" 




13 


ChangeEventP o1icy = "pp r" /> 




14 

- 

csearchRegion Binds="EmpView2 Iterator" Criteria="" 




15 


Customizer ="oracle.jbo.uicli.binding.JUSearchBindingCustomizer 




16 


id= "EmpView2 Que ry" /> 




17 


</executables> 




18 

B 

<bindings> 




19 

- 

CattributeValues IterBinding="DeptViewlIterator" id="Deptno"> 




20 

- 

<AttrHames> 




21 


cltem Value="Deptno"/> 




22 


</AttrHames> 




23 


</attributeValues> 




24 

- 

CattributeValues IterBinding="DeptViewlIterator" id="Dname"> 


V 


Overview 

Source History < 

>g 



http://www.kingtraining.com 


119 


Copyright @2010, John Jay King 


















ADF Bindings XML file (.cpx) ^ 

Training Resources f \ I / ) \ 


B DeptEmpJSFPage.jspx I IP DeptEmpJSFPagePageDef.xml 0DataBindlngs.cpx | [^Emp.xml 




AD 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 


|c?HTil veEsion="l. 0" encoding="UTF-8" ?> 

E <Application xmlns = "http: //xmlns.OEacle.com/adfm/applieation rr 

veEsion= rr ll. 1.1.54. 7 rr id="DataBindings" SepaEateXHLFiles="f alse" 

Package = "myadf.view" C1ientType = "Gene e ic"> 

E <pacjetlap> 

<page p ath= "/D ep tEmp J 3 FP age.j spx" 

us ageI d= "myadf_vie w_D ep tEmp J 3 FP age P ageD e f” /> 

</pageMap> 

□ <pageDefinitionlfsages> 

3 <page id="myadf_vieu_DeptEmpJ3FPagePageDef" 

p ath= "myadf. vi e w. p ageD e f s. D ep tEmp J 3 FPage P ageD e f" /> 

</pa(jeDefinitionUsacjes> 

E <dataControlUsages> 

E <BC4JDataControl id= "MyAD FAppHo duleD ataC ont e o 1" P ack age= "myadf.model" 

FactoEyClass="oEacle. adf.model.bc4j.DataContEO1FactoEyImp1 
3upp o e PsTe ans ac tions = "tEue" 3upp o e ts FindHo de = "tEue" 

3upp o e tsRange siz e = "tEue" 3upp o e tsRe s e t31ate = "tEue" 
3uppoEts3oEtCollection="tEue" 

C onfiguE ati on= "HyAD FAppHo dule L o c al" syncHo de = "Imme diate" 
xmlns="http: //xmlns.OEacle.com/adfm/datacontEol"/> 

</dataControlUsages> 

< /Application 
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AA# ADF Faces ViewController Files T 

Training Resources f J V 


• The XML files representing 
the ViewController project are 
distributed using a directory 
structure 


□ & View controller 
0 Si adfmsrc 

Si META-INF 
0 Si myadf 
3 view 

£3 pageDefs 

0 Q classes 
0 Si -data 

Q 00000000 
0 Si -wisjsps 

Q jsp_servlet 

Si meta-inf 
0 Si myadf 

0 Si view 

Q pageDefs 
0 Si public_html 
- & WEB-INF 
0 Q temp 

0 Si a df 

0 Si styles 
Si cache 
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Available Books 


t 



• Oracle JDevloper llg Handbook 

- Duncan Mills, 

Peter Koletzke, 

Dr. Avrom Roy-Federman 

- Oracle Press 

• Oracle Fusion Developer's Guide 

- Frank Nimphius, 

Lynn Munsinger 

- Oracle Press 
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AZ&tf Wrapping It Up ^ 

Training Resources X I I I ) \ 

• Oracle Forms is not going anywhere; it is not 
necessary to “convert” things to ADF 

• Oracle’s design emphasis and new features will 
support the Java-based ADF mechanism; Oracle 
Forms probably won’t see much in the way of new 
functionality 

• JDeveloper and ADF allow me to create simple 
forms almost as easily as in forms except: 

• ADF BC for data creates reusable components 

• ADF Faces for view creates reusable components 

• I did not write a single line of Java in this demo! 
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Training Days 2011 

Save the dates! 


February 15-17 2011 





ODTUG Kaleidoscope 2010 



June 27-July 12010 
Washington, DC 










Training Resources 


Please fill out session Evaluations 
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